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message if it is available. Otherwise, no icon or a generic icon is used. According to the presently preferred embodiment, a type 
table (20) is maintained by a type updater (12) component The type includes a list of message types and subtypes together with 
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ENHANCED ELECTRONIC MAIL SYSTEM INCLUDING METHODS AND 
APPARATUS FOR IDENTIFYING MIME TYPES AND FOR DISPLAYING DIFFERENT 

ICONS 

This application is a continuation-in-part of application serial number 09/209,162 filed 
December 10, 1998, the complete disclosure of which is hereby incorporated by reference 
herein. This application is related to copending application serial number [BAK-007] filed 
simultaneously herewith, the complete disclosure of which is also hereby incorporated by 
reference herein. 

BACKGROUND OF THE INVENTION 

1. Field of the Invention 

The invention relates to an electronic mail program. More particularly, the invention 
relates to an electronic mail program having a mailbox browser display which displays different 
icons for different types of mail item MIME types. 

2. State of the Art 

In recent years electronic mail ("email") has become widely used in business, education, 
and in personal communications. One of the features of electronic mail which is most 
convenient, particularly in business and in education, is the ability to attach a binary computer 
file to an email message. This feature enables email correspondents to rapidly share word 
processing documents, database documents, spreadsheet documents, multimedia documents, or 
virtually any kind of binary file created by a computer. There are, however, some serious 
limitations and inconveniences associated with attaching a binary file to an email message. 

The original Internet mail system as defined in 1982 with RFC (Request for Comments) 
821 and 822 had a number of important limitations. In particular, the system was not designed 
to carry large quantities of arbitrary data in an email message. In fact, the 1982 SMTP (Simple 
Mail Transport Protocol) standard required that an email message consist of a single message 
containing only ASCII characters in lines of 1000 characters (blocks of 32k) or less. 

The ability to send binary data through the Internet electronic mail system was made 
possible with the MIME (Multipurpose Internet Mail Extensions) standard for Internet 
messages. The original MIME standard was published as an Internet Request For Comments 
document (RFC 1341) and approved in June of 1992. (See Internet RFCs 2045,2046, and 2047 
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for the latest MIME standards documents.) The MIME standard describes how an email 
message should be formatted in order to be considered MIME compliant. MIME defines a set 
of message header fields and a set of message encoding standards that are designed to overcome 
the limitations of RFC 822 message formats and still be transportable through any of the 
numerous legacy mail transport systems in use on the Internet. (See specifically, N. Freed and 
N. Borenstein, Multipurpose Internet Mail Extensions (MIME) Part 1 : Format of Message 
Bodies . Network Working Group, Request For Comments (RFC 2045) November 1996.) 
MIME message header fields extend those defined in RFC 822 and describe the content and 
encoding type of the email message. Encoding schemes allowed in the MIME standard include 
"quoted-printable", and "base64". In addition, three unencoded data types are allowed. These 
are labeled "8bit'\ "7bit", or "binary". It should be noted that legacy gateways still do not 
handle binary data and nearly all MIME compliant messages encode binary data as "7bit", the 
default encoding for MIME. 

Today MIME is implemented in all of the major electronic mail clients or "User 
Agents", e.g. Microsoft Outlook and Outlook Express, Netscape Communicator, and 
Qualcomm Eudora, However, only a few MIME types including "text/plain", "text/html", 
"multipart/alternative", and "multipart/mixed" can be handled by these programs. Probably the 
most important feature of the MIME standard that was that it allowed any binary data to be 
appropriately encoded and sent through the older SMTP system of mail gateways and 
exchanges. Mail client programs such as those listed above were modified to allow users to 
attach any type of file to a mail message. This was done by (a) including an appropriate 
encoding module to translate the binary data of an arbitrary file to an acceptable MIME 
encoding such as "7bit" or "base64", (b) expanding the Mail client's ability to handle messages 
with a MIME type set to "multipart", and (c) including the file specified by a user as a part of 
the "multipart" message. For many years, mail client programs offered users only the two 
choices; they could send a simple text message (sent with "content-type = text/plain") or they 
could attach any file to a simple text message (sent with "content-type = multipart/mixed"). 

More recendy the programs listed above have been extended to allow authors to use 
basic types of text formatting such as alternative fonts and styles by including these features in 
the mail client text editor and sending the message with a MIME type set to "text/html". Today 
Microsoft's Outlook even allows a person to use Word, a full featured text editor, to author 
electronic mail messages by converting the Word file format to HTML before manually 
inserting it into the body of the mail message for sending. Nevertheless, mail client programs 
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still rely exclusively on file attachments with message MIME types set to "multipart" for any 
other type of file format. 

« 

If the sender and the receiver of the email message with the attached binary file are using 
the same brand and version of email program and both programs are configured in substantially 
the same way, the receiver's email program should automatically apply the appropriate decoding 
to the attached binary file and produce a file which is identical to the file which was attached to 
the email by the sender. However, if the sender and receiver are using different email programs, 
the recipient may receive a file which must be decoded by the recipient using a separate 
decoding program. 

Even after the file is properly received and decoded, it is often difficult for the receiver of 
the file to open the file. The receiver of the file might expect that "clicking" on the file icon will 
open the file. However, clicking on the file icon will often not open the file. It may result in an 
error message like "application not found" or, worse, it may result in the file being opened by an 
inappropriate application thereby displaying "gibberish". The receiver of the file must have a 
program capable of reading (opening) the file. For example, if one attaches a spreadsheet file to 
an email message, the receiver of the file must have a spreadsheet program in order to open the 
file. Technically, it is not necessary that the receiver of the file have the same brand program as 
that which created the file. However, opening a file with a program which did not create it, 
though possible, can be very inconvenient. The receiver of the file must know what kind of file 
is attached to the email message, must know what program on their computer is capable of 
reading that type of file, must launch the program, must open the file from within the program, 
and wait while the program translates the file. 

The limitations of Internet electronic mail can become even more frustrating if the sender 
and recipient are not using the same operating system (OS). Some mail attachment encoding 
schemes (and file compression schemes) are OS-dependent and it is possible that an email 
recipient could receive a file which is impossible to decode (or decompress). 

These limitations in electronic mail have discouraged many people, particularly non- 
sophisticated computer users, from attaching files to electronic mail messages. In fact, for some 
novice users, the task of launching one application to create a document, saving the document, 
launching a separate email application to create an email message, and then locating the saved 
document for attachment to an email message is daunting enough to discourage them. In 
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addition, novice users often complain that after "downloading" a file attached to an email 
message they cannot find the file on their hard disk. 

Most email client software allows the user to sort items in the inbox by sender, subject, 
or date in order to locate more easily a particular mail item. In addition, most email client 
software indicates whether a particular message includes an attached file. This is indicated by an 
icon such as a paper clip icon or a generic document icon or a floppy disk icon, for example. 
However, the same icon is used regardless of the nature of the attachment and there is no way of 
knowing the nature of the attachment until the message is opened. Prior art Figure 1 shows an 
example of a typical email inbox where some of the mail items have attached files indicated by 
the paper clip icon to the left of the subject name. Though not specifically shown in Figure 1, 
those skilled in the art will appreciate that generic icons, such as !, a, A , 4, etc., may also be 
displayed alongside the message subject to indicate various "properties" of the message, such as 
whether it is a high priority message, whether you have already replied to the message, etc. 
These generic icons are usually monochromatic font characters taken from a "dingbats" font or 
the like. 

In the most recent versions of the major email client programs, an icon that represents 
the file type of an attached file is displayed in the body of the mail message after the message is 
opened by the user. This is possible because computer operating systems such as Microsoft 
Windows or Macintosh OS maintain data that associates information with each file type known 
to the system. This information includes a graphical icon and the location of programs that may 
be used to "open", "edit", or to perform a handful of other actions on the file. For example, in 
Microsoft Windows the system registry includes entries for each file type that is known to the 
system and at least some of the information described above is associated with the file type. 
When a user opens an electronic mail message with "content-type = multipart/mixed", a mail 
client program built for Microsoft Windows (e.g. Microsoft Outlook) determines that the 
second part of the message was an attached file, identifies a line of text within the message such 
as, Attachment Converted: "c:\attach\aFile.doc", looks in the system registry for the icon 
associated with the file type ".doc", and displays the graphical icon inside the body of the 
message. 

In current systems, MIME type is not used to associate icons to files, rather the file type 
extension is used. This creates important limitations in the ability to associate different versions 
of software or documents created by different versions of the. software with different icons. For 
example all documents created by MS Word, regardless of which version of Word was used, 
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have the same file type (file extension) and as a result are associated with the same icon. This is 
true even though many newer versions of the files cannot be read by older versions of the 
software. 

My previously incorporated parent application discloses electronic mail software which 
includes a main email component and a number of installable components. The installable 
components include authoring/reading components for creating/reading different kinds of 
documents and mailbox components for listing different kinds of messages or for listing 
messages in different styles. The main email component provides an underlying graphical user 
interface for functions directly associated with the storage and transfer of electronic mail 
messages, and also handles all data bundling and unbundling required to transform a message 
created by an authoring component into a MIME compliant message. The authoring/reading 
components act like applications embedded within the email program and allow specific types of 
documents such as spreadsheets, graphics, databases, etc. to be created from within the email 
program and emailed directly. The authoring/reading components also allow received 
documents to be read without the difficulties traditionally associated with attaching binary files 
to an email letter. The authoring components of the invention pass data to the main email 
component which packages the data as a MIME compliant message. When the message is 
received, the main email component concatenates (as needed) and decodes the MIME message 
and sends the data to the authoring/reading component associated with the MIME type. 

My previously incorporated parent application broadly disclosed and claimed mailbox 
handling software whereby messages of different types are displayed in different ways in a 
mailbox listing within the context of the modular component email software. 

It is believed that certain features disclosed in my parent application are applicable to any 
email client software and may be used to improve the process of attaching files to email and 
using files attached to email. 

SUMMARY OF THE INVENTION 

It is therefore an object of the invention to provide an electronic mail program which 
includes an inbox list whereby different kinds of messages and attached documents are 
displayed with different kinds of icons. 
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In accord with this object which will be discussed in detail below, electronic mail client 
software according to the invention has a mailbox displayer which lists messages together with 
an icon for each message where the icon is associated with the MIME type of the message. 
Mail which contains a file attachment is listed in the inbox with an icon indicative of the type of 
file attached to the email. The mailbox displayer interprets the MIME type and selects the 
appropriate icon either from the icon registry in the OS or from a directory of icons maintained 
by the email client software. For example, if an email with an ADOBE ACROBAT file 
attachment is received, the ADOBE ACROBAT icon will appear in the mailbox listing alongside 
the mail item listing. In addition, if a message is created with a special authoring/reading 
component as described in my parent application, the icon associated with the authoring/reading 
component will be displayed in the mailbox listing as part of the line displaying the mail item. 

The electronic mail software of the present invention is described by example with 
reference to the email software of my parent application which includes a main email component 
and a number of installable components which communicate bidirectionally with the email 
component through an application programming interface (API). The installable components 
include authoring/reading components as well as a mailbox displayer component. According to 
the presently preferred embodiment, a component is also included for maintaining a database of 
icons. 

The mailbox displayer component functionality is invoked by the user when the mailbox 
is opened, when the list of mail is scrolled, etc. The mailbox displayer component preferably 
includes all of the functionality of state-of-the-art mailbox displayers and includes the 
functionality of looking to a directory of icons for display with information about the message 
based on the MIME type of the message. In the Lingo embodiment, a data structure is created 
for each message with an additional TYPE field that is based on the MIME type and subtype of 
the message. The internal TYPE field is used to associate MIME types to icons. Another 
embodiment uses the contents of "content-type" (MIME type) header of the message directly to 
associate with icon images. If there is no appropriate icon in the directory of icons, the mailbox 
displayer uses icon image data contained in a subpart of the MIME message if it is available. 
Otherwise, no icon or a generic icon is used. According to the presently preferred embodiment, 
a type table is maintained by a type updater component. The type table includes a list of 
message types and subtypes together with filenames of scalable icons to be used by the mailbox 
displayer. The invention prefers scalable icons so that the icon can be sized to accompany the 
font size chosen to display the mailbox contents. 
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Several embodiments of the type updater component are provided. According to the first 
embodiment, icons are installed/removed manually by the user. According to a second 
embodiment, icons are automatically installed/removed when modular authoring/reading 
components are installed/removed. According to a third embodiment, new icons are added 
automatically whenever a new message type is encountered by the mailbox displayer. The new 
icon is retrieved from either the operating system registry or from the icon image data embedded 
in the message. According to a fourth embodiment, the type updater automatically queries a 
network server for new icon information and downloads icon image data as needed. 

Additional objects and advantages of the invention will become apparent to those skilled 
in the art upon reference to the detailed description taken in conjunction with the provided 
figures. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a screen shot of a prior art electronic mailbox displayer; 

Figure 2 is a screen shot of an electronic mailbox displayer according to the invention; 

Figure 2a is a screen shot of an electronic mailbox displayer according to an alternate 
embodiment of the invention; 

Figure 3 is a block diagram of the component organization of an electronic mail client 
according to the invention; 

Figure 4 is a simplified flow chart illustrating the basic operation of a mailbox displayer 
according to the invention; 

Figure 5 is a simplified flow chart illustrating the basic operation of an alternate 
embodiment of the mailbox displayer according to the invention; 

Figure 6 is a simplified flow chart illustrating icon lookup for different mail item 
properties; 

Figure 6a is a simplified flow chart illustrating icon lookup for MIME type; 
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Figure 6b is a simplified flow chart illustrating icon lookup for filetype of attachments; 

Figure 7 is a simplified flowchart illustrating the initialize_TypeTable function of one 
embodiment of the type updater component; 

Figure 8 is a simplified flowchart illustrating the read_TypeTable_file function of one 
embodiment of the type updater component; 

Figure 9 is a simplified flowchart illustrating the write _TypeTable_file function of one 
embodiment of the type updater component; 

Figure 10 is a simplified flowchart illustrating the read_iconJSles_toJRAM function of 
one embodiment of the type updater component; and 

Figure 1 1 is a simplified flowchart illustrating the installJType function of one 
embodiment of the type updater component. 

BRIEF DESCRIPTION OF THE APPENDICES 

Appendix A is a program listing for MACROMEDIA DIRECTOR of a mailbox 
displayer according to the invention; and 

Appendix B is a program listing for MACROMEDIA DIRECTOR of a type updater 
according to the invention. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 

Referring now to Figure 2, electronic mail client software according to the invention has 
a mailbox displayer which lists messages together with an icon for each message where the icon 
is associated with the MIME type of the message. Mail which contains a file attachment is 
listed in the inbox with an icon indicative of the type of file attached to the email. For example, 
as shown in Figure 2, the mail message entitled "Minutes of Meeting" is listed with a 
MICROSOFT WORD icon indicating that the email message has a WORD file attached to it. 
The message entitled "New Radio Ad" is listed with a QUICKTIME WAV icon indicating that 
an audio file is attached to the email. The message entitled "New Ad Brochure" has an 
attached ADOBE ACROBAT file as indicated by the ACROBAT icon. Similarly, the message 
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"Sales Forecast" is displayed with an EXCEL spreadsheet icon; the "Customer Database" 
message is displayed with a FILEMAKER PRO database icon; and the message "Year End 
Accounting" is displayed with a QUICKEN icon. According to the invention, the mailbox 
displayer interprets the MIME type of the message and/or the MIME type or document type of 
the attachment, if any, and selects the appropriate icon either from the icon registry in the OS or 
from a directory of icons maintained by the email client software. 

The electronic mail software of the present invention is described by example with 
reference to the email software of my previously incorporated parent application which includes 
a main email component and a number of installable components which communicate 
bidirectionally with the email component through an application programming interface (API). 
The installable components include authoring/reading components as well as at least one 
mailbox displayer component. Figure 2a illustrates an embodiment of the email software of my 
previously incorporated parent application which displays an icon indicative of the 
authoring/reading component associated with the mail message. This embodiment is also 
capable of receiving email from (and sending email to) prior art email clients. Figure 2a 
illustrates a mailbox list where two mail items are shown with two icons, i.e. a paper clip and an 
ACROBAT icon and a paper clip and a PHOTOSHOP icon. The dual icon display indicates 
that the mail was created without any special authoring/reading component and has an 
attachment created by some other program, in this case ACROBAT and PHOTOSHOP. 

As mentioned above, the electronic mail software of the present invention is described by 
example with reference to the email software of my previously incorporated parent application 
which includes a main email component and a number of installable components. According to 
the presently preferred embodiment, a component is also included for maintaining a database of 
icons. Figure 3 illustrates the relationship between these components. 

As shown in Figure 3, a data structure 10 referred to as TYPETABLE is created and 
maintained by a component 12 referred to as TYPEJJPDATER. A working example of a 
TYPEJJPDATER according to the invention is illustrated in Appendix B which is described in 
more detail below. The primary purpose of the TYPETABLE is to be read by the 
MBOX.DISPLAYER component 14. The TYPEJJPDATER 12 and MBOXJDISPLAYER 
14 communicate with each other using function calls and a shared data structure, TYPETABLE. 
For example, the MBOXJDISPLAYER includes a call to the function "initialize TYPETABLE" 
(306, Figure 6a) inside the TYPEJJPDATER component. The MBOXJDISPLAYER 
communicates with the electronic mail client software using the API described in the parent 
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application and or in previously incorporated serial number [BAK-007]. As shown in Figure 3 
the MBOXJDISPLAYER component 14 and the electronic mail client software 16 also have 
bidirectional access to the store of electronic mail messages in the user's mail boxes. According 
to the presently preferred embodiment, the electronic mail messages are stored with an optional 
TYPE field which includes information drawn from the MIME type and subtype header fields 
of the message if the message is created by an installable application component of the kind 
described in the parent application. 

The MBOXJDISPLAYER component functionality is invoked by the user when a 
mailbox is opened, when the list of mail is scrolled, etc. Those skilled in the art will appreciate 
that most electronic mail client software provides a number of different mailboxes such as inbox, 
outbox, read mail, sent mail, etc. The MBOX_DISPLAYER component 14 preferably includes 
all of the functionality of state-of-the-art mailbox displayers and also includes the functionality 
of looking to the TYPETABLE (and as explained in more detail below, to look into the body of 
a MIME message) to find an appropriate icon for display alongside a message title in the 
mailbox display. According to the presently preferred embodiment, icons are stored as small 
image files, e.g. EPS files or GIF files, and are pointed to by the TYPETABLE data structure. 
In order to accommodate the use of different size fonts in the mailbox display, means for scaling 
the size of the icon graphics are also provided. Three methods may be used. First, the image 
may be scaled using a standard interpolation algorithm. Second, multiple copies of icon images 
with different resolutions may be stored and retrieved to match a limited number of font point 
sizes. Third, and presently preferred, a combination of the first two methods is used whereby at 
least one image for each icon is stored, the icon most closely matching the point size of the font 
is chosen and then scaled as needed to better match the font point size. 

Table 1 illustrates how the TYPFTABLE data is stored in permanent storage (e.g. hard 

disk). 
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mimetype 


icon filename 




msg handler filename 


text/plain 


c:\kidcode\textgif 


c:\kidcode\txt.dxr \ 


x-application/ 
rebus 


c:\kidcode\rebus.gif 


c:\kidcode\rebus.dxr 


x-application/grid 


c:\kidcode\grid.gif 


c:\kidcode\grid.dxr 


x-application/graph 


c i\kidcode\graph.gif 


c:\kidcode\grph.dxr 








multipart/mixed 


c:\kidcode\paperclip.gif 




Table 1 



Table 1 illustrates at least five mimetypes. The first four are mimetypes which utilize installable 
components for authoring/reading. The installable components are indicated by the ".dxr" file 
extension. The multipart/mixed (fifth) mimetype illustrated in Table 1 indicates an attachment 
created with an external application rather than an installable component. As mentioned above 
with reference to Figure 2a, a generic paper clip icon is used to distinguish this attachment from 
mail messages created with installable components. 



Table 2 illustrates the typetable data structure as it is loaded into RAM. 



mimetype 


ptr 


icon filename 


msg handler filename 


text/plain 


20 


c:\kidcode\textgif 


c:\kidcode\txtdxr 


x-application/ 
rebus 


21 


c:\kidcode\rebus.gif 


c:\kidcode\rebus.dxr 


x-application/grid 


22 


c:\kidcode\grid.gif 


c:\kidcode\grid.dxr 


x-application/graph 


23 


c:\kidcode\graph.gif 


c:\kidcode\grph.dxr 










multipart/mixed 


19 


c:\kidcode\paperclip.gif 





Table 2 
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When the data structure TYPETABLE is loaded into RAM it is referred to as SGJTYPETABLE 
and has a structure as shown in Table 2. This structure includes a pointer to the icon. The 
pointer in the exemplary embodiment is a LINGO castmember. 

As mentioned above, according to the exemplary embodiment, when the email message 
has an attached file, a generic attachment icon is displayed and an icon particular to the 
attachment is also displayed. This second icon is pointed to by a data structure in RAM which 
is created on the fly (e.g. as illustrated in Figure 6b) referred to as 
SG_ATTACHJTYPETABLE. The basic structure of SG_ATTACH_TYPETABLE is 
illustrated in Table 3. 



File Extension 


icon pointer 


program filename 


.doc 


30 


c:\programs\winword.exe 


.pdf 


31 


c:\programs\acrobatexe 


.html 


32 


c:\programs\netscape.exe 


.htm 


32 


c:\programs\netscape.exe 


.xml 


32 


c:\programs\netscape.exe 









Table 3 



As shown in Table 3, the file extension is associated with an icon pointer and the pathname to 
the program which will be used to read the attachment. As discussed in more detail below with 
reference to Figure 6b, the SG_ATTACH_TYPETABLE is built on the fly using icons from the 
system registry. 

A presently preferred embodiment of a MBOXJ3ISPLAYER component is presented 
in detail in Appendix A which is similar to Appendix B of my previously incorporated parent 
application. The code listing shown in Appendix A hereto differs from the code listing of the 
parent application starting at line 287 which is the start of the main mailbox display function. 
The main mailbox display function is also illustrated by the flowchart of Figure 4 Referring 
now to Figure 4 and Appendix A, the function starts at line 287 in Appendix A and at the 
START 101 in the flowchart of Figure 4. Before displaying the mailbox contents, pointers to 
the TYPETABLE and associated system features are set up as illustrated at lines 293-300 in 
Appendix A and at 103, 105 in Figure 4. The various mailbox fields, e.g. message number, 
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subject, date, message read indicator, are cleared at lines 302-307 in Appendix A and at 107 in 
Figure 4. "Sprite channels" (MACROMEDIA graphic holders) which will be used to display 
icon graphics are cleared at lines 309-3 1 1 in Appendix A and at 107 in Figure 4. Next the 
message list is displayed starting at line 313 in Appendix A and at 109 in Figure 4. The 
elements which make up each line of the mailbox display (e.g. the message subject, the date, the 
sender's name, as well as the graphical elements) are referred to as "properties". These 
properties are read from the message at lines 320-326 in Appendix A and at 1 1 1, 1 13 in Figure 
4. With the exception of mailbox, mimetype, and status, all of the properties are automatically 
displayed when read as illustrated at 1 1 1 in Figure 4 and lines 320-323 in Appendix A. The 
mailbox, mimetype, and status properties are read at 1 13 in Figure 4 and lines 324-326 in 
Appendix A. According to the presently preferred embodiment, the mimetype icon is also used 
to display message status. If the message has been read, the icon is displayed in grayscale. If 
the message has not been read, the icon is displayed in color. The steps of finding the icon and 
setting it to grayscale or color are illustrated at lines 328-355 of Appendix A. The sprite channel 
counter is set at lines 332-334 in Appendix A and at 1 15 in Figure 4. The TYPETABLE data 
structure is parsed at lines 340-343 in Appendix A and at 1 17 in Figure 4. If the TYPETABLE 
does not contain the icon indicated by the mimetype for this message, then a default icon is 
chosen at lines 344-346 in Appendix A and at 1 19 in Figure 4. If the status for the message 
indicates that it (its attachment) has been read, then the grayscale version of the icon is set at 
lines 348-349 in Appendix A and at 121 in Figure 4. The chosen icon is added to an icon list 
for rapid access during scrolling of the mailbox contents list. This is illustrated at lines 351-352 
in Appendix A and at 123 in Figure 4. The remainder of the main mailbox display function at 
lines 354-374 in Appendix A and at 125 in Figure 4 concern locating the text and icons at 
appropriate screen locations. The code shown at lines 315-374 repeats for the number of 
messages in the mailbox as illustrated by the decision at 127 in Figure 4. When there are no 
more messages to be listed, the main mailbox display function ends as illustrated at 376 in 
Appendix A and 129 in Figure 4. 

Though not presendy illustrated in the code or flowchart, as mentioned above, if there is 
no appropriate icon in the directory of icons, the mailbox displayer uses icon image data 
contained in a subpart of the MIME message if it is available. Those skilled in the art will 
appreciate that this functionality is easily performed by reading the icon image data from the 
location in the MIME file which is defined by the standard(s) referenced above. Code to 
implement this might be inserted at line 325 of Appendix A or at line 345 of Appendix A. 
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As mentioned above, the remainder of Appendix A is substantially the same as the 
mailbox component of Appendix B of the parent application and the description of it is 
adequately set forth in the previously incorporated parent application. Those skilled in the art 
will appreciate that the code listings of the Appendices are particular to the MACROMEDIA 
DIRECTOR development suite and that the same functionality may be achieved using a 
different development environment. Figure 5 illustrates the functionality of the mailbox display 
function in a more generic manner which can apply to different programming languages. 

Referring now to Figure 5, the mailbox display starts at 201 to read the list of messages. 
It checks at 202 to determine whether the TYPETABLE has been initialized. If it has not, the 
TypeTable is initialized at 204 as described in detail below with reference to Figure 1. The 
mailbox display gets the next message listing at 203. For the message listing obtained at 203, 
the mailbox proceeds to obtain properties for the listing at 205 and property values at 207. If it 
is determined at 209 that the property uses an icon for display, a "get icon" routine is called at 
211 (this routine is illustrated at Figure 6). The message properties that concern the present 
application are (a) the message MIME type and (b) whether the message has a file attachment. 
In the flow charts in Figure 5 (209) the system looks up whether current message property 
which is implemented as a LINGO symbol, e.g. #type, #date, #mai!box, #status, is represented 
by an icon. Although in the current implementation, each property is coded separately, the more 
general implementation described in the flowchart of Figure 5 could be accomplished by 
checking whether the target symbol, e.g. #type was an element of a list data structure, e.g. 
Properties_with_Icons = (#type, #has_attachment) in procedure 209 of Figure 5. The icon is 
displayed at 213. If it was determined at 209 that the property does not use an icon, the property 
value is displayed at 215. At 217 it is determined whether there are additional properties for this 
message listing. If there are, the program returns to 205. If there are not, it is determined at 219 
whether there are more message listings to list. If there are, the program returns to 203. If there 
are not, the program ends at 221. 

Figure 6 illustrates a generalization of the functionality contained in Appendix A at lines 
328-350. This is the generalized "get icon" routine called at 211 in Figure 5. The routine starts 
at 301 having been provided the property name and property value by the calling program. If it 
is determined at 303 that the property is "mimetype" or, to conform to the LINGO 
implementation, "#type", the icon of the mimetype is obtained at 305 and a pointer to the icon is 
passed back to the calling program at 307. The actual steps involved in getting the icon for a 
mimetype are illustrated in Figure 6a. If it is determined at 309 that the property is "has 
attachment", the icon for "has attachment" is obtained at 31 1 and a pointer to the icon is passed 
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back to the calling program at 307. The procedure that gets the me attachment icon is described 
in Figure 6b for a Microsoft Windows platform. Alternatively, the TYPETABLE data structure 
could include a field for filetype that is used to map from file extensions to MIME types and 
MIME type icons. If TYPEDATA were modified in this way, both message type and file type 
icon lookups would use the TYPETABLE. A related modification in the TYPE_UPDATER 
would be required to install the filetype/MIMEtype associations as they are encountered either 
via a previously unknown message type or a previously unknown file type. Because file type 
extensions are not as rich as Mimetypes, the same file type extension may map to many 
different MIME types. For example this could occur for different versions of the same software 
if the software manufacturer assigns different MIME subtypes for different versions of their 
software. 

If it is determined at 313 that the property is "message read", the icon for "message 
read" is obtained at 315 and a pointer to the icon is passed back to the calling program at 307. 
If it is determined at 317 that the property is "priority", the icon for "priority" is obtained at 319 
and a pointer to the icon is passed back to the calling program at 307. From the foregoing, 
those skilled in the art will appreciate that many different icons can be displayed for different 
properties. 

Figure 6a illustrates a generalization of the implementation contained at lines 328-346 of 
Appendix A. This is the "get icon for mimetype" function called at 305 in Figure 6. This 
routine starts at 302 having been given the "mimetype" by the calling program. It determines at 
304 whether the TYPETABLE has been initialized. If not, initialization is performed at 306. 
The initialization routine may reside in the TYPEJJPDATER component or may call functions 
that reside in the TYPE_UPDATER component. For example, in the LINGO implementation, 
the function Read_TypeTable_File (Figure 8), which is part of the TYPEJJPDATER 
component is used to initialize the TYPETABLE data structure. After initialization, or if it was 
determined at 306 that the TYPETABLE was already initialized, the mimetype is used to retrieve 
an icon pointer from the TYPETABLE at 308. See Appendix A, lines 328-342. It is determined 
at 310 whether the icon pointer is null. If it is, an "install message type" routine is called at 312. 
The "install message type" routine, which is contained in the TYPEJJPDATER component, is 
explained in detail below with reference to Figure 1 1 which illustrates the installation of new 
message handlers and icons for mimetypes. If the icon pointer is not null, it is determined at 
314 whether the icon pointer points to "icon not installed". If that is the case, the icon pointer is 
set to the default pointer at 316. In either case, a non-null pointer is returned to the calling 
program at 318. 
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Figure 6b illustrates an exemplary procedure for getting an icon for an attachment to an 
email message. Starting at 320, the file extension of the attachment is read. (Note that on a 
Windows platform, the three letters following V in a filename determine the "filetype". With 
other platforms, such as the Macintosh platform, the filetype and "creator code" are listed in the 
"resource fork" of the file. Thus, for those platforms, the first step will be to read the filetype 
(and creator code) from the resource fork of the file.) Once the filetype (or filetype and creator 
code) have been determined, the routine attempts at 322 to find an appropriate icon in the 
SGJTYPETABLE. If it is determined at 324 that no appropriate icon has been found, the 
routine attempts at 326 to find an appropriate icon in the SG_ATTACH JITPETABLE. If it is 
determined at 328 that no appropriate icon has been found, the routine attempts at 330 and 332 
to find an appropriate icon in the system registry. (Note that with other operating systems, icon 
resources may be stored in different places. E.g., in the Macintosh OS, icon resources are 
stored in the invisible "desktop" file.) If at 334 a suitable icon is found, a pointer to the icon is 
set at 336 and the pointer is written to the SG_ATTACH_TYPETABLE at 338. The icon 
pointer is returned to the mailbox displayer at 340. See 31 1 in Figure 6 and 21 1 in Figure 5. If 
a suitable icon is not found at 342, no icon pointer is provided. 

Turning now to Appendix B, lines 1-26 provide an overview and introduction to the 
Type Updater. The Type updater includes eleven functions. Three of the them are public 
functions called by the mailbox displayer. These include: Initialize_TypeTable, 
Install_Type, and Uninstall_Type. The remaining eight functions are private functions used 
within the Type Updater. These include: WriteJTypetable _File, ReadJTypetableJFile, 
Read_IconJRles_To_RAM, read_iconFile, delete_mimetype, insertjmimetype, delete_filetype, 
insert_filetype. The InitializeJTypeTable function is illustrated in Figure 7 and at lines 29-60 in 
Appendix B. The function begins at 360 in Figure 7, sets the SGJTYPETABLE to nil at 362 
(line 39 in Appendix B). The SG_ATTACH_TYPETABLE is set to nil at 364 (line 43 in 
Appendix B). The Typetable file stored on disk is read into SGJTYPETABLE at 366 (line 44 
in Appendix B). The read_typetable_file internal function is illustrated in Figure 8 and at lines 
207-252 in Appendix B. An error check is performed at 368 (line 46 in Appendix B) to 
determine whether any data was loaded into RAM. If no data was read, the user is alerted at 370 
(line 47 in Appendix B) and a failure is returned at 372 (line 48 in Appendix B). Otherwise, 
icon files are read into RAM at 374 (line 5 1 in Appendix B). An error check is performed at 
376 (line 47 in Appendix B). If the data was read successfully, the function ends at 378 (line 60 
in Appendix B). 
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Turning now to Figure 8 and at lines 207-252 in Appendix B, the read_typetable_file 
function starts at 380 (line 218 in Appendix B). The SGJTYPETABLE is set to nil at 382 (line 
222 in Appendix B). The typetable.txt file is opened at 384 (lines 224-227 in Appendix B) and 
a file open error check is performed at 386 (line 229 in Appendix B). If an error in opening the 
file is detected, an error alert is produced at 388 and (line 230 in Appendix B), the file is closed 
at 390 (line 231 in Appendix B), and a SG_TYPETABLE is returned at 392 (line 232 in 
Appendix B). If the file was opened without error, the first line is read at 391 which begins a 
loop (steps 394-408) which ultimately ends at 394 when the end of file is reached after which 
the file is closed at 390 (line 231 in Appendix B), and a SG_TYPETABLE is returned at 392 
(line 232 in Appendix B). As shown in Appendix B at lines 235-239, the LINGO 
implementation reads the entire file into a string and simulates line by line reading because 
LINGO cannot read line by line. When a line is read, the first word in the line is the mimetype 
(line 243 in Appendix B). The rnimetype is inserted into SG_TYPETABLE at 396 (line 244 in 
Appendix B). If the mimetype is not defined as discovered at 398, the user is alerted at 400 and 
the next line is read at 391 . If the mimetype is defined, the next word in the line (filetype) is 
read and inserted into SGJTYPETABLE at 402 (line 245 in Appendix B). The next word in the 
line (iconFileName) is read and inserted into SGJTYPETABLE at 404 (line 246 in Appendix 
B). The next word in the line (msgHandler) is read and inserted into SGJTYPETABLE at 406 
(line 247 in Appendix B). Any errors detected at 408 are reported at 400. As mentioned above, 
the process continues until the typetable.txt file is completely read. 

The function Write_TypeTable_File is described in Figure 9 and at lines 159-206 of 
Appendix B. This function writes the contents of SGJTYPETABLE back to typetable.txt after 
new mimetypes and icons have been added to the SGJTYPETABLE via the InstallJType 
function described below with reference to Figure 1 1. The Write_TypeTable_File function 
begins at 410 (line 163 in Appendix B) and first checks at 412 (line 168 in Appendix B) 
whether the SGJTYPETABLE structure is empty. If it is empty, it returns an error message at 
414 (line 169 in Appendix B) and a failure message at 416 (line 170 in Appendix B). If the 
SGJTYPETABLE structure is not empty a backup copy of the typetable.txt file is created at 418 
(line 173 in Appendix B) and a new empty file is created at 420 (lines 176-180 in Appendix B). 
An error check is performed at 422 (Tine 181 in Appendix B) and if an error is detected in 
creating the new file, an error message is returned at 424 (line 182 in Appendix B). The backup 
file is restored at 426 (line 183 in Appendix B) and a return code is set to "fail" at 428 (line 184 
in Appendix B). The typetable.txt file is closed at 430 (line 203 in Appendix B). The backup is 
deleted at 432 (line 204 in Appendix B) and the return code is returned at 434 (lines 205-206 in 
Appendix B). If there is no error creating the new file, it is opened for write access at line 187- 
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188 in Appendix B and a starting line counter is set at line 191. The first (next) entry in the 
SGJTYPETABLE is read at 436 (line 192 in Appendix B). If it is determined at 438 (line 193 
in Appendix B) that the end of SG_TYPETABLE has been reached, the return code is set to 
"success" at 440 (line 201 in Appendix B), the file is closed 430, the backup is deleted 432 and 
the return code is returned 434. 

Until the end of SGJTYPETABLE is reached, data is set to write at 442 and the 
mimetype is written at 446 (line 194 in Appendix B) to a string. The filetype, iconfilename, and 
messagehandlerfilename are added to the string at 446, 448, and 450 respectively (lines 195-197 
in Appendix B). The string is written to the new typetable.txt file at 452 (line 198 in Appendix 
B) and a line delimiter is written at 454 (lines 199-200 in Appendix B). The function loops 
back to 436 and continues until all of the entries in SGJTYPETABLE are read and written to the 
new typetable.txt file. 

Figure 10 illustrates the function Read Jfcon_Files JTo_RAM which is presented in 
Appendix B at lines 255-290. Starting at 456 in Figure 10 (line 255 in Appendix B), the 
function first determines at 458 (line 259 in Appendix B) whether any mimetypes are defined in 
the structure SGJTYPETABLE. If there are none, no icons are defined, an error message is 
returned at 460 (line 260 in Appendix B), the return code is set to "fail" at 462 (line 261 in 
Appendix B) and the return code is returned at 464 (lines 261-262 in Appendix B). If the 
structure SGJTYPETABLE is not empty, the function loads the default icon into RAM and sets 
a pointer to it at 466 (line 265 in Appendix B). Icon pointer numbers are related to LINGO 
castNumbers at line 268 in Appendix B and a counter for incrementing the castNumbers is set 
at line 270. The first (next) entry in the structure SGJTYPETABLE is read at 468 (line 271 in 
Appendix B). If it is determined at 470 (line 272 in Appendix B) that there are no more entries 
to read, the return code is set to "success" at 472 and the return code is returned at 464 (line 288 
in Appendix B). So long as entries remain, the mimetype is read at 474 and the iconfilename is 
for the mimetype is read at 476 (line 273 in Appendix B). If it is determined at 478 (line 274 in 
Appendix B) that there is no icon associated with this mimetype, the default icon pointer is 
assigned to it at 480 (line 275 in Appendix B). Otherwise, the next icon bitmap and pointer are 
read at 482 (line 277 in Appendix B) using the function read_iconfile (lines 295-298 in 
Appendix B). If the icon pointer is not nil as determined at 484 (line 278 in Appendix B), the 
castNum is incremented at line 279. Otherwise the castNum is not incremented and the default 
icon pointer is used at 480 (line 280 in Appendix B). In either case, the icon pointer associated 
with the mimetype is inserted at 486 (line 283 in Appendix B). The counter is incremented at 
line 284 and the next entry from SGJTYPETABLE is read at 468 (line 285 in Appendix B). 
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Figure 1 1 illustrates the function install_type which is used to install a new icon and/or 
message handler for a particular mimetype or filetype. The function starts at 600 with input 
which includes an icon file name, a message handler program name, and either a mimetype or a 
filetype (lines 71-75 in Appendix B). This input can be provided by the user or by an automatic 
means as described below. The typetable file is read into RAM at 602 (line 78 in Appendix B) 
thereby creating SGJTYPETABLE. If SGJTYPETABLE is empty as deteimined at 604 (line 
80 in Appendix B), an error is returned at 606 (lines 8 1-82 in Appendix B). Otherwise, the 
mimetype (or filetype) specified at 600 is retrieved at 608 (line 87 in Appendix B) from 
SGJTYPETABLE if it exists. If the mimetype (or filetype) exists in SGJTYPETABLE and if it 
is already associated with an icon and message handler, the user is prompted at 612 (line 90 in 
Appendix B) whether it should be redefined. If the user chooses NO, an error is returned at 614 
(line 94 in Appendix B). If the mimetype was not previously defined or if the user chooses to 
redefine it, the message handler program specified at 600 is checked for validity (e.g. whether it 
is present on the hard disk or network) at 616 (line 102 in Appendix B). If it is not valid, an 
error is returned at 614 (lines 104-105 in Appendix B). If the message handler and the 
mimetype (filetype) are valid, they are associated with each other in SGJTYPETABLE at 618 
(line 108 in Appendix B). Next, the icon file name specified at 600 is checked for validity at 
620 (line 1 10 in Appendix B). If it is not valid, the default icon is specified at 622 (line 112 in 
Appendix B) and an error alert is returned at 624 (line 1 1 1 in Appendix B). In either case, the 
icon file name specified or the default icon, if necessary, is associated with the message handler 
and the mimetype (filetype) in SGJTYPETABLE at 626 (line 1 14 in Appendix B). The 
rypetable.txt file is written back from SGJTYPETABLE at 628 (lines 122-125 in Appendix B) 
and unless an error is encountered, a success is returned at 630 (line 126 in Appendix B). 

Those skilled in the art will appreciate that the install_type function can be called by 
another program so that icons are automatically installed/removed when modular 
authoring/reading components are installed/removed. Though not specifically shown in code or 
drawings herein, those skilled in the art will appreciate how to implement this second 
embodiment by referring to Appendix B herein and the component installing code of the parent 
application. 

According to a third embodiment, new icons are added automatically whenever a new 
message type is encountered by the mailbox displayer. The new icon is retrieved from either the 
operating system registry or from the icon image data embedded in the message. Those skilled 
in the art will appreciate the implementation of this embodiment by reference to Appendix B 
herein and the above referenced MIME standards. 
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According to a fourth embodiment, the type updater automatically queries a network 
server for new icon information and downloads icon image data as needed or as scheduled. 
Those skilled in the art will appreciate that automatic updaters which download data from a file 
server are well known and that this embodiment may be implemented by reference to the known 
automatic updaters together with Appendix B herein. 

There have been described and illustrated herein several embodiments of an enhanced 
electronic mail system including methods and apparatus for identifying mime types and for 
displaying different icons. While particular embodiments of the invention have been described, 
it is not intended that the invention be limited thereto, as it is intended that the invention be as 
broad in scope as the art will allow and that the specification be read likewise. Thus, while 
particular code listings have been disclosed, it will be appreciated that other code could be 
utilized. For example, although the Appendices illustrate the invention with MACROMEDIA 
DIRECTOR LINGO code, the invention could be embodied with C++, based on a 
"MOZDLLA" engine, or via a number of other popular development tools. Also, while the 
invention has been disclosed with reference to the applicant's parent application which involves 
an email client having installable authoring/reading components, it will be recognized that the 
principles disclosed herein for displaying icons representing mimetypes in a mailbox listing 
may be applied to other kinds of email clients. Moreover, while particular configurations have 
been disclosed in reference to the way icon images are stored (i.e. scalable images), it will be 
appreciated that other configurations could be used as well. Further, while the invention has 
been shown with reference to display on a computer screen, it will be appreciated that the display 
may be on a television, a personal digital assistant, a cell phone, a wrist watch, etc. It will 
therefore be appreciated by those skilled in the art that yet other modifications could be made to 
the provided invention without deviating from its spirit and scope as so claimed. 
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Appendix A - Mailbox Displayer Code - Page 1 

1 — MBOX _DISPLAYER IMPLEMENTATION 

\ Code for a mailbox handler for the KidCode electronic mail client. 

3 This Director MIAW displays a mailbox in a window as a list 

4 — of messages with one line for each message. Each message has the following fields displayed- 
j — 1. message number r J ' 
6 — 2. Message sender 

I ~ 2* ^ essa S e mimetype & status (single icon used to indicate both properties) 

8 — 4. Message subject header 

9 — 5. Message date 
10 

11 

12 onstartMovie 

1 3 global SGJastActiveWindow — super global that keeps track of KC last active window 

1 4 global mbxG_username — current user name 

1 5 global mbxG_messages — list of messages 

*° global mbxG_nMsgs — number of messages in mailbox 

1 7 global mbxG_J)oxName — current mailbox name 

1 8 global mbxG_whichLine — current hilite line = msgNumber 

19 global mbxG_subtractLine 

20 global mbxG lips 
21 

22 set mbxG Jips = 0 
23 

24 — called by API to Main Movie 

25 tell the stage to emh_continue(#mailbox) 

26 end 
27 

28 

29 on activate Window 

30 global SGJastActive Window 

31 global mbxG_my Window 

32 set SG JastActiveWindow = mbxG_my Window 

33 end activateWindow 
34 

35 

36 — Stop movie handlers 

37 

38 StopMovie handler in a MIAW is called only when the movie 

39 — plays through to the end or jumps to another movie. 

40 — It isn't called when the window is closed or the window 

41 — is deleted by the forget window command. 
42 

43 on stopMovie 

44 cleanUpMovie() 

45 end 

46 ■ - 

47 called to close a MIAW or automatically whenever 

48 — forgetWindow is called 
49 

50 on closeWindow 

51 cleanUpMovieQ 
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52 end 

53 

54 

55 — cleanUpMovie can be called by both stopMovie and 

56 — closeWindow. 
57 

58 on cleanUpMovie 

59 global mbxG_whichLine 

60 global mbxG_subtractLine 

61 global mbxG_nMsgs 

62 global mbxG_username 

63 global mbxGJips 
64 

65 — CLEAR FIELDS AND GLOBAL VARIABLES 

66 

67 put into field "MailboxTitle" 

68 put into field "prepositionTitle" 

69 put " M into field "MessageNumber" 

70 put into field "MailboxTo" 

71 put into field "MailboxSubject" 

72 put <m into field "MailboxDate" 

73 put <tM into field "Messageread" 
74 

75 set mbxG_nMsgs = 0 

76 set mbxG_iips = 0 

77 resetHiliteQ 
78 

79 if findEmpty(member 50) > 50 then 

80 set the scriptText of member 50 = 

81 end if 
82 

83 set the memberNum of sprite 6 = the memberNum of member "lips up' 

84 set the loc of sprite 4 to point(800, 4) 

85 set the loc of sprite 5 = point(800, 19) 

86 end cleanUpMovie 
87 

88 

89 — API Public Handlers : 

90 — 

91 — Ugly hack to work around problem with Director startup 

92 — of MIAWs. The problem is that, after calling a handler in the 

93 — MIAW, the StartMovie handler for the MIAW does not run until 

94 — the calling movie advances to its next frame. 

95 — Therefore, the calling sequence in the calling movie 

96 — has to be engineered so that the real handlers in the MIAW do not 

97 — run until after control has been transfered back to the calling 

98 — movie. However, at least one handler in the MIAW must be called 

99 — by the calling movie before the StartMovie handler will run. 
100 

101 — startMeUp is the fake handler that, when called by the 

102 — main movie, will upon return to the main movie, 
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1 03 — cause this movie* s startMo vie handler to run. 
104 

J05 — The second part of this wormy hack is contained in the MIAW's 

106 — startMovie handler... It is a call to a workAround handler in 

107 — the calling movie called continueComponent 

J 25 — ^ calling movie's continueRebus handler calls the real handlers 

1 09 — in the MIAW. 

110 

111 on emc_startMeUp 

112 — put "Macromedia sucks !" 

113 return(TRUE) 

1 1 4 end emc_startMeUp 
115 

116 — — 

1 17 initWindow is called by email main when a message handler 

118 — is opened 
119 

120 on emc_initWindow userName, windowName 

1 2 1 global mbxG_my Window 

1 22 global mbxG_usemame 
|23 global mbxG_platformType 

1 25 — put "ENTER emcjnitWindow mailbox" 

1 26 set mbxG_username = userName 

127 set mbxG_my Window = windowName 
128 

!?2 — puppet the hilite (MB 4-17-99) removed this 

130 resetHilite() 

131 tell the stage to emh_getColorDepth() 

132 set colorDepth = the result 

1 33 mapColors(colorDepth) 

1 34 tell the stage to emh_getPlatformType() 

1 35 set mbxG_platformType = the result 
136 

1 37 — put "EXIT emcjnitWindow mailbox" 
138 

139 return(TRUE) 
140 

1 41 end emc_initWindow 
142 

143 — 



144 — closeWindow is not called unless Rebus plays as 

145 —a MIAW. 
146 

147 on emc_close Window 

1 48 — put "ENTER emc_closeWindow Mailbox" 

149 closeWindow() 

150 — step frame 

151 — put "EXIT emc_closeWindow Mailbox" 

152 return(TRUE) 
153 
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1 54 end emc_closeWindow 
155 

156 

157 

158 on e mc_getCo mpo nentlnf o 

159 return( list( "SimpleMail", 1, #mailbox, "text" ) ) 

160 end emc_getComponentInfo 
161 

162 

163 

164 on mbx _getMessage 

165 — 

1 66 "open" button and doubleClick of highlighted message 

1 67 calls to email main to hand the message 

168 selected to a message handling movie 

169 This script was previously the "open" cast memeber script: 

170 — 

171 — global mbxG_whichLine 

172 — global mbxG_messages 

173 — 

174 — set mailData = getAt(mbxG_messages, mbxG_whichLine) 

175 — 

176 — return(mailData) 

177 — 

178 — 

179 — 

1 80 — end mbx_getMessage 
181 

182 

183 

1 84 on mbx_getMessageNumber 

1 85 global mbxG_whichLine 

1 86 retum(mbxG_whichLine) 

1 87 end mbx_getMessageNumber 
188 

189 

190 — mbx_JrashMessages returns a list of messages that are to 

191 — be trashed in the mailfile. Email main will rewrite the mail file 

192 — When implemented correcdy, it will determine which message numbers 

193 — are associated with the currentiy selected lines in the mailbox 

194 — display, update the display to remove these messages from the 

195 — list, and return the list of deleted message numbers. 
196 

197 on mbx_trashMessages 
198 

1 99 global mbxG_messages — list of messages 

200 global mbxG_nMsgs — number of messages in mailbox 

201 global mbxG_whichLine — current hilite line = msgNumber 
202 

203 — set mailData = getAt(mbxG_messages, mbxG_whichLine) 

204 — 
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205 tell the stage 

206 — retum(mailData) 

207 end tell 

208 

209 — needs implementation that can handle multiple messages 

210 — also need to rewrite trashlt which does not conform to 

211 — API rule that only API handlers can be called in other movies 

212 — 

213 — set message = mbxG__messages 

214 if mbxG_whichLine > 0 AND mbxG_whichLine <= mbxG_nMsgs then 

215 tell the stage to emh_alertUserToTrash() 

216 set yes = the result 

217 if not yes then return [] user canceled 
218 

219 set trashList = list(getAt(mbxG_messages, mbxG_whichLine)) 

220 deleteAt(mbxG_messages, mbxG_whichLine) 

221 set mbxG_nMsgs = mbxG_nMsgs - 1 

222 displayMailbox(mbxG_messages) 

223 resetHiliteO 

224 else 

225 alert("Please click on the message you wish to delete.") 

226 set trashList = [] 

227 end if 
228 

229 return(trashlist) 
230 

23 1 end mbxJrashMessages 
232 

233 

234 — accepts a mailbox datastructure that consists of a boxname and 

235 — a list of messages 
236 

237 on mbx__openMailbox mailbox 

238 global mbxG_u semame 

239 global mbxG_jnessages 

240 global mbxG_boxName 

241 global mbxGjMsgs 
242 

243 — put "ENTER mbx_openMailbox" 

244 set mbxG_boxName = getAt(mailbox, 1) 

245 put mbxG_userName & '"s " & mbxG _boxName into field "mailboxTitle' 
246 

247 set mbxG_messages = getAt(mailbox, 2) 

248 set mbxG_nMsgs = count(mbxG_messages) 
249 

250 displayMailbox(mbxG__messages) 
251 

252 — put "EXIT mbx_openMailbox" 

253 return(TRUE) 
254 

255 end mbx_openMailbox 
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256 

257 

258 

259 Utilities - 
260 



26 1 Initialize formatting of text fields 

262 — Thanks to Frank Leahy for this one 

264 on SetTextlnfo fldName, fldValue, fldAlign, fldFont, fldSize, fldStyle 

265 if fldValue o EMPTY then 

266 put fldValue into field fldName 

268 seuhe textAlign of field fldName = fldAlign 

269 set the textFont of field fldName = fldFont 

270 set the textSize of field fldName = fldSize 

27 1 set the textStyle of field fldName = fldStyle 

272 end 



273 
274 



275 on formatFields 

277 — FORMAT THE TEXT FIELDS 

279 setTextlnfo "MessageNumber", " "left", "ariaT, 14 ;bold" 

280 setTextlnfo "MailboxTo", " », W,' 'arial', .14, "bold" 

281 setTextlnfo "MaUboxSubject", " ", "left", "anal 14 bold 
oV> setTextlnfo "MailboxDate", " ", "left", "arial", 14, "bold- 
Ill setTexSnfo "Messageread"', " ", "left", "arial", 14, "bold" 
284 

285 end formatFields 

287 — MAEN MAILBOX DISPLAY FUNCTION 

288 — displays a Mailbox style listing of messages 

289 places the appropriate components from each message 

290 — into field members with lines aligned for display 
291 

292 on ^^^^^le _ super globa i variable shared across different MIAWS 

294 global mbxG_red 

295 global mbxG_platformType 

296 global mbxG_iconList 
297 

298 — mbxG JconList for future use in up/down scroll scripts 

299 set mbxG_iconList = [:] 

300 set count = 0 
301 

302 first clear all the fields and the sprites 

303 put into field "MessageNumber" 

304 put ,m into field "MailboxTo" 

305 put — into field "mailboxSubjecf 1 

306 put i-i into field "mailboxDate" 
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307 put into field "Messageread" 

309 repeat with i = 40 to 70 

3 JO set the member of sprite i = member "blank" 

311 end repeat 

312 

I M — Fill the text fields with info from all of the messages so that it is available 

314 — when the window scrolls 

3 1 5 repeat with msg in msgList 
316 

3 J 1 with the exception of mailbox, mimetype and status, 

319 * e flCldS Wil1 automaticall y be displayed when filled 

320 put the HneCount of member "MailboxTo"+l & RETURN after field "MessageNumber" 

321 pu t getProp(msg, #from) & RETURN after field "MailboxTo" 

322 put getProp(msg, #subject) & RETURN after field "mailboxSubject" 

323 put getProp(msg, #date) & RETURN after field "mailboxDate" 

324 put getProp(msg, #mailbox) into mailbox 

325 put getProp(msg, #mimetype) into mime 

326 put getProp(msg, #status) into status 
327 

328 Display the mimetype icon 

329 — - We use the mimetype icon to also indicate message status. A greyscale version of the 
J JU — icon is displayed if a message has been read. Otherwise a color icon is displayed. 

332 Icons will be placed in sprite channel 40 and beyond 

333 set i = 40 + count 

334 set count = count + 1 
335 

336 — find the icon for the message mimetype 

HI c0 ^ e should be rewritten using a data access function. For now we need to 

338 know the format of the TYPETABLE data structure 

|2? set mimeProperties = getProp(SG_TYPETABLE, mime) 

3^ numbe? C ^ Member = ^ etAt ( mimePro P ertie ^ 2 > — seco *d item is the cast member 

343 ^ 

3*4 — tos l yP e is unknown then use the default icon 

if iconCastMember = 0 then set iconCastMember = the number of member 

-Wo Defaultlcon 
347 

HI ~ get ^ ^yscale version of the icon if the message has been read 

if status = "R" then set iconCastMember s iconCastMember + 1 

351 — add the icon to the list of icons used for scrolling the window 

352 append (mbxJconList, iconCastMember) 

— P lace Ae icon at * e proper location for display 

355 set the memberNum of sprite i to iconCastMember 
356 

357 _ display the icon in the correct grid cell in the mailbox message list. 
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358 — set the locH of all icons to 50 

359 set whereGoesIcon = the lineCount of member "MailboxTo" 

360 puppetSprite i, TRUE 

36 1 set the visible of sprite i = TRUE 

362 set the locH of sprite i to 50 
363 

364 — precise placement of the icon next to it's message... 

365 set positonVar = 105 + linePosToLocV(member "MailboxTo", whereGoesIcon) 

366 set the locV of sprite i to positonVar 

of 1 — but don t let icons faU S° be y° nd window if there are many messages 

368 if positonVar > 550 or positonVar < 105 then 

369 set the visible of sprite i = FALSE 

370 else 

37 1 set the visible of sprite i = TRUE 

372 end if 

373 addProp mbxGJconList, (the locV of sprite i), mime 

374 end repeat 
375 

376 end displayMailbox 
377 

Vnl ~ 5y T ^ IONS USED TO RESPOND TO USER INTERACTION WITH MAILBOX 

acn — HILITE MESSAGE is called when a user clicks a mouse on a message line 

381 on hiliteMessage whichLine 

382 global mbxG_nMsgs, mbxG_whichLine, mbxG_subtractLine, mbxG_messages 

384 — KEEP TRACK OF SELECTED LINE 
385 

386 set mbxG_whichLine = whichLine 
387 

388 — MAKE SURE LINE IS VALID 
389 

390 if mbxG_ whichLine <= 0 then 

391 return(0) — do nothing, errors are caught elsewhere 

392 else if mbxG_whichLine > mbxG_nMsgs then 

393 — user clicked somewhere else in field 

394 set mbxG_whichLine = 0 — reset to 0 

395 return(O) 

396 end if 
397 

398 — HIGHLIGHT SELECTED LINE * 
399 

400 set whichHighlight = mbxG_whichLine + mbxG_subtractLine 
401 

402 — since all field members in display are kept synchronized 

403 — any one will do for UnePosToLocV 

404 — use "MailboxTo", it's small 
405 

406 set the loc V of Sprite 1 1 to 

Inc ( " + linePosToLocV ( me mber "MailboxTo", whichHighlight)) 
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410 — WhCn ^ USCr d ° uble clicks on a hilited message, go get it from mailFile 

411 if the doubleclick then 

412 set mail data = getAt(mbxG_messages, mbxG_whichLine) 

413 tell the stage 

4 14 emh_openMessage(maildata) 

415 end tell 

416 — mbx eetMessagef) 

417 end if 
418 

4 1 9 end hiliteMessage 

420 

421 

422 ■ 

423 on resetHilite 

424 global mbxG_whichLine, mbx subtractLine 
425 

426 set mbxG_whichLine = 0 

427 set mbxG_subtractLine = 0 
428 

429 — SET HIGHLIGHT OFF STAGE 

430 set the loc of sprite 1 1 to point (11, -20) 

432 end resetHilite 

433 

434 — this is a lookup table for color 

435 — only really necessary for Mac platform 

436 — use on any color that you want to 

437 — set the forecolor of field 
438 

439 on mapColors colorDepth 

440 global mbxG_red 

44 1 global mbxG Jriue 

442 global mbxG_white 

443 global mbxG_black 
444 

445 case colorDepth of 

446 

447 8: 

448 set mbxG_red = 6 

449 set mbxG J>lue = 4 

450 setmbxG white = 0 

451 16: 

452 set mbxG_red = 3 1 744 

453 setmbxG_blue = 31 

454 set mbxG_white = 32767 

455 32: 

456 set mbxG_red = 1 67 1 1 680 

457 set mbxG_blue = 255 

458 set mbxG_white = 1 67772 1 5 
459 
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460 end case 

461 

462 set mbxG J>lack = the forecolor of line 1 of member the member of sprite 4 

463 

464 end mapColors 
465 

466 — — 

467 scripts run when the mouse is clicked on a mailbox message line, 

468 A script is needed for each field in the message line. 
469 

470 on mouseUp 

47 1 hiliteMessage (the clickon - 40) 

472 end 
473 

474 

475 on mouseDown 
476 

477 global mbxG_Jips 

478 set whichLine = the mouseLine 

479 if mbxGJips then 

480 set astr = line whichline of field "MailboxTo" 

481 speak(astr) 

482 else 

483 hiliteMessage(whichLine) 

484 end if 

485 end 
486 

487 on mouseDown 
488 

489 global mbxGJips 

490 set whichLine = the mouseLine 

49 1 if mbxGJips then 

492 set astr = line whichline of field "MailboxSubject" 

493 speak(astr) 

494 else 

495 hiliteMessage( whichLine) 

496 end if 

497 end 
498 

499 

500 more scripts run when the mouse is clicked on a mailbox message line 
501 

502 on mouseDown 

503 global mbxGJips 

504 set whichLine = the mouseLine 

505 if mbxGJips then 
506 

507 set astr = line whichline of field "MailboxDate" 

508 set aday = word 1 of astr 

509 case aday of 

510 "Mon put "Monday" into word 1 of astr 
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l]\ 'Tue,": put 'Tuesday" into word 1 of astr 

^ J i "Wed,": put "Wednesday" into word 1 of astr 

l\* 'Thu,": put 'Thursday" into word 1 of astr 

%\* "Fri,": put "Friday" into word 1 of astr 

l\l "Sat,": put "Saturday" into word 1 of astr 

"Sun,": put "Sunday" into word 1 of astr 
jj' otherwise 
518 end case 

519 

520 speak(astr) 

521 else 

f?2 hiliteMessage(whichLine) 

523 end if 

524 end 
525 

526 on mouseDown 

527 global mbxGJips 
528 

529 set whichLine = the mouseLine 

530 if mbxGJips then 

2?i set = line whichline of field "MessageNumber" 

5 ^2 speak(astr) 

533 else 

534 hiliteMessage(whichLine) 

535 end if 

536 end 
537 

538 

539 — this script is attached to the message type icon which is displayed in the message line 

541 on mouseUp 

542 set whichLine = the mouseLine 

543 hiliteMessage(mouseLine) 

544 end 
545 

546 code for scroll buttons 

547 

548 on mouseDown 

549 global mbxG_whichLine 

550 global mbxG_subtractLine 

55 1 global mbxG_iconList 
552 

553 — SCROLL UP WITH HIGHLIGHT 

58 ~ ESES ^P^CROLL... HOWEVER, ICON SPRITE POSITION IS BASED ON 

556 NUMbIr" SVBTRACTLWE > NOT ON THE THE ACTUAL COR^pSndSg LINE 

557 _ OF THE MESSAGE IN THE MAILBOX WINDOW. 

559 set numberOflcons Var = count(mbxG JconList) 

560 set lastlconPos = getPropAt(mbxG JconList, count(mbxG iconList)) 
5ol if lastlconPos >= 550 then ~* 
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562 — there are enough messages to make scrolling nessisary 

563 repeat while the mouseDown = TRUE 
564 

565 — oldSubtractLine gets set to mbxG_subtractLine before mbxG_sub. gets 

566 — incremented. This keeps the icons from falling one position behind 

567 — it's prospective message 
568 

569 set oldSubtractLine = mbxG_subtractLine 

570 set mbxG_subtractLine = mbxG_subtractLine + 1 
571 

572 if mbxG_subtractLine > 0 then 

573 set mbxG_subtractLine = 0 

574 end if 
575 

576 — SCROLL ALL FIELDS TOGETHER 
577 

578 scrollByLine member "MessageNumber", -1 

579 scrollByLine member "MailboxTo", -1 

580 scrollByLine member "MailboxSubject", -1 

581 scrollByLine member "MailboxDate", -1 

582 scrollByLine member "mime", - 1 

583 scrollByLine member "Messageread", -1 
584 

585 set numberOflcons = the lineCount of member "MailboxTo" + 40 

586 set amountOfMail = the lineCount of member "MailboxTo" 
587 

588 — for debugging 

589 — put "linecount:" & the lineCount of member "MailboxTo" 

590 — put "subtractline:" & mbxG_subtractLine 
591 

592 repeat with i = 40 to numberOflcons 

593 

594 

595 — if the following 2 conditions are true, then scroll the icons 

596 — i.e. if messages scroll, icons do too, if not, then neither do icons. 
597 

598 if mbxG_subtractLine >= - amountOfMail + 1 and oldSubtractLine < 0 then 

599 set the locV of sprite i = the locV of sprite i + 15 

600 if the locV of sprite i < 105 then 

60 1 set the visible of sprite i = FALSE 

602 else 

603 set the visible of sprite i = TRUE 

604 end if 

605 else 

606 nothing 

607 end if 

608 end repeat 
609 

610 — MOVE HIGHLIGHT WITH LINE, MOVING HIGHLIGHT 

611 — OFF SCREEN WHEN LINE MOVES OFF SCREEN 

612 set whichHighlight = mbxG_whichLine + mbxG_subtxactLine 
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613 if whichHighlight <= 0 or whichHighlight >= 22 then 

014 set the loc of sprite 1 1 to point (11, -20) 

615 else — set the locV of highlight to scrolled message 

617 endif ^ ° f SpiitC 1 1 * ( " + UnePosToLocV (member "MailboxTo", whichHighlight)) 

618 updateStage 

619 end repeat 

620 end if 

621 end 
622 

623 on mouseUp 

624 set numberOflcons = the lineCount of member "MailboxTo" + 40 

625 repeat with i = 40 to numberOflcons 

if ^ locV of sprite i > 550 or the locV of sprite i < 105 then 

5iZ set the visible of sprite i = FALSE 

628 else 

629 set the visible of sprite i = TRUE 

630 end if 

631 end repeat 

632 end 
633 

634 on mouseDown 

635 global mbxG_whichLine 

636 global mbxG_subtractLine 

637 global mbxG iconList 
638 

639 

641 MKS^I^ND 8 SCROLLED ' ICONS NEED TO MOVE WITH THE 

642 THE MEMBERNUM 

644 XfTCR C ° N SPRITES BE ASSIGNED TO THE NEW MESSAGE THAT IS VISIBLE 

645 — BEING SCROLLED. 

85 ~~ iSS£E ^?XJF ROLL "- HOW EVER, ICON SPRITE POSITION IS BASED ON 

SZ NU^ER* SlJBTRACrLlNE > NOT ON THE THE ACTUAL CORRESPONDlRa LINE 

649 — OF THE MESSAGE IN THE MAILBOX WINDOW 

650 set numberOflcons Var = count(mbxG JconList) 

65 1 set lastlconPos = getPropAt(mbxG_iconList, count(mbxG iconList)) 
o52 if lastlconPos >= 550 then " 

$2 — 1iim m enough messages to make scrolling nessisary 

&54 repeat while the mouseDown = TRUE 

~5 scrollByLine member "MessageNumber", 1 

gjj scrollByLine member "MailboxTo", 1 

scrollByLine member "MailboxSubject", 1 

Jgjj scrollByLine member "MailboxDate", 1 

659 scrollByLine member "mime", 1 

ffV scrollByLine member "Messageread", 1 

66 1 ii^^^ ER USE ° T ° CORRECT FOR DISCREPANCY 

663 — THE MOUSELINE AND THE LINEPOSTOLOCV 
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664 _ THE MOUSELINE GIVES LINE WITHIN FIELD TOTAL 

665 _ THE LINEPOSTOLOCV USES LINE OF FIELD ON SCREEN 

666 set mbxG_subtractLine = mbxG_subtractLine - 1 

667 set numberOflcons = the lineCount of member "MailboxTo + 40 

668 set amountOfMail = the lineCount of member "MailboxTo" 

669 — put "linecount:" & the lineCount of member "MailboxTo" 

670 — put "subtractline:" & mbxG_subtractLine 

67 1 repeat with i = 40 to numberOflcons 

672 if mbxG_subtractLine >= - amountOfMail + 1 then 

673 set the locV of sprite i = the locV of sprite i - 15 

674 if the locV of sprite i <105 then 

675 set the visible of sprite i = FALSE 

676 else 

677 set the visible of sprite i = TRUE 

678 end if 

679 else 

680 nothing 

681 end if 

682 end repeat 
683 

684 if mbxG_subtractLine < - amountOfMail + 1 then 
6g5 set mbxG_subtractLine = - amountOfMail + 1 

686 end if 

688 — MOVE HIGHLIGHT WITH LINE, MOVING HIGHLIGHT 

689 — OFF SCREEN WHEN LINE MOVES OFF SCREEN 
690 

691 set whichHighlight = mbxG_whichLine + mbxG_.su btract Line 

692 if whichHighlight <= 0 or whichHighlight >= 22 then 

693 set the loc of sprite 11 to point (11, -20) 

695 elSC set the locV of Sprite 11 to (99 + UnePosToLocV(member 

696 "MailboxTo", whichHighlight)) 

697 end if 

698 updateStage 

699 end repeat 

700 end if 

701 end 
702 

703 

704 

705 on emc JndicateCheckinglnternet 

706 global mbxG_red 

707 global mbxG_blue 

708 global mbxG_white 

709 global mbxG_black 
710 

711 if the locH of sprite 4 > 600 then 

712 set the loc of sprite 4 = point(223, 4) 

713 end if 

714 — if the locH of sprite 5 > 600 then 

715 — set the loc of sprite 5 = point(509, 19) 

716 — end if 
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717 

718 set colorNow = the forecolor of line 1 of member the member of sprite 4 

720 case colorNow of 

721 mbxG_black: set colorNext = mbxG_blue — blue 

722 mbxG J)hie: set colorNext = mbxG_white — pink 
4^3 mbxG_white: set colorNext = mbxG_red — red 

724 mbxG_red: set colorNext = mbxG_blue — blue 

725 end case 
726 

727 . set the forecolor of line 1 of member the member of sprite 4 to colorNext 

728 updateStage 
729 

730 end emcJjidicateCheckinglntemet 

732 on emc^endlndicateCheckinglnternet 

733 set the loc of sprite 4 to point(800, 4) 

734 set the loc of sprite 5 = point(800, 1 9) 

735 cursor -1 

736 updates tage 

737 end emc_endIndicateCheckingInternet 
738 

739 Scripts for the close window button 

740 

741 on mouseDown 
742 

743 repeat while the stillDown 

if inside(point(the mouseH, the mouseV), the rect of sprite the clickon) then 

1Z\ tf the name of member the member of sprite the clickon = "closeWindow" 

'4o then 

747 set the member of sprite the clickon = "closeWindow_down" 

™ updateStage 

749 end if 

750 else 

751 set the member of sprite the clickon = "closeWindow" 

752 updateStage 

753 end if 

754 end repeat 

755 set the member of sprite the clickon = "closeWindow 1 ' 

756 updateStage 
757 

758 end mouseDown 
759 

760 on mouseUp 
761 

762 — Close the window 

763 if inside(point(the mouseH, the mouseV), the rect of sprite the clickon) then 

764 — these next to lines are to try and speed up 

765 — the disposal of the mailbox icons on close 

766 — need to check this on slower machine. 

767 hideMaUIcons(the lineCount of member "MailboxTo") 
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768 go frame "stop" 

769 tell the stage to emh_kiUComponent(0, 

770 set success = the result 

77 1 if success o TRUE then 

772 alertCerror closing mailbox MIAW") 

773 end if 

774 end if 

775 end 
776 

777 on hideMaillcons numberOflcons 

778 repeat with i = 40 to (40 + numberOflcons) 

779 set the visible of sprite i = FALSE 

780 end repeat 

781 updateStage 

782 end 
783 

784 

785 — script for the open button 
786 

787 on mouseDown 
788 

789 repeat while the stillDown . 

790 if inside(point(the mouseH, the mouseV), the rect of spnte the clickon) then 

79 1 if the name of member the member of sprite the clickon = "open" then 

792 set the member of sprite the clickon = "open_down" 

793 updateStage 

794 end if 

795 else 

796 set the member of sprite the clickon = "open" 

797 updateStage 

798 end if 

799 end repeat 

800 set the member of sprite the clickon = "open" 

801 updateStage 

802 end mouseDown 
803 



804 
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805 on mouseUp 
806 
807 



gYo lf mbxG_whichLine = 0then ~ 

8 1 1 " Select a message by clicking with your mouse." 



812 end if 

813 



814 3S?S5" getAt(mbxG - messa 8 es > mbxG_whichLine) 

| j I emh_openMessage(maildata) 



end tell 

817 end if 

818 end 
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1 — TYPEJJPDATER IMPLEMENTATION 

2 — Code for a component that maintains message type information for the 

3 — KidCode electronic mail client 

4 — This Director MIAW makes public functions available for calling by other components 

5 of KidCode 
6 

7 — public functions 

8 — 1. Initialize JTypeTable 

9 - — 2. Install_Type 
10 — 3. UninstallJType 
11 
12 
13 



14 

15 
16 
17 
18 
19 
20 
21 
22 
23 
24 



25 — Filename for permanent storage version of TYPETABLE file 

26 — typetable.txt —default directory is the currentPath directory 
27 

28 

29 — INITIALIZE JTYPETABLE initializes the data structures used to lookup Mime type 

30 icons, attachment filetype icons and message handler MlAWs. 

3 1 — The SG JTypetable is set up prior to itfs use. File attachment information is not looked 

32 up until it is used when a message with an attached file is encountered. 
33 

34 on InitializeJTypeTable 

35 global SGJTYPETABLE — super global variable shared across different MIAWS for 

36 Typetable 

37 global SG_ATTACH JTYPETABLE — maintains info for attachment filetypes 
38 

39 set SGJTYPETABLE = [:] - initialize property list for mimetype information 
40 

41 — initialize property list for filetype information 

42 — this list will be filled only as messages with attachments are encountered 

43 set SG_ATTACH JTYPETABLE = [:] 

44 set SGJTYPETABLE = ReadJTypeTable_File(the pathname & " typetable.txt") 
45 

46 if count(SG JTYPETABLE) = 0 then - failed to read typetable file 

47 alert ("Error: Failed to read the file of MIMEtypes") 

48 return (0) 

49 end if 
50 

5 1 set retVal = Read_Icon_Files_To_RAMQ 



private functions nfor internal use only 

1. Write_Typetable_File 

2. ReadJTypetable_File 

3. Read__Icon_FilesJTo_RAM 

4. read_iconFile 

5. delete_mimetype 

6. insert_mimetype 

7. delete_filetype 

8. insert_filetype 
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52 

53 ifretVal = Othen 

54 alert("Error: Failed to load MIME type icons.) 

55 return (0) 

56 else 

57 retum(l) 

58 end if 
59 

60 end — InitializeJTypeTable 

61 

62 

63 

64 -- INSTALL JTYPE is used to install a new MIME type into the system. 

65 INSTALLJTYPE takes as input a mimetype (string), a filename of the message handling 

66 movie, an filename of the bitmap that contains the mimetype icon and, optionally, a file 

67 extension (string). The function adds the information associated with the MIME type 

68 (given by the function parameters) into the MIME type table recorded in permanent storage. 

69 Here we use the file "typetable.txt" for permanent storage of the MIME type info. 
70 

71 on InstallJType mimeToInstall, msgHandler_filename, icon_filename, filetype 

72 global SGJTYPETABLE — information on all installed MIME types 
73 

74 set DEFAULT JCONHLE = "defaultIcon.bmp" 

75 set SGJTYPETABLE = [:] — initialize property list for mimetype information 
76 

77 —read the existing MIME type information into RAM 

78 set SGJTYPETABLE = ReadJTypeTable_File(the pathname & " typetable.txt") 
79 

80 if count(SG_TYPETABLE) = 0 then - failed to read typetable file 

8 1 alert ("Error: Failed to read the file of MIMEtypes") 

82 return (0) 

83 end if 
84 

85 — Check to see if mimetype is already installed 
86 

87 set mimeProperties = get_mimetype(mimeToInstall) 
88 

89 if mimeProperties o 0 then — mimetype is already installed . 

90 set redefineAlert = baMsgBox(theMessage, "KidCode", "YesNoCancel", "Question", 1) 
91 

92 — the alert function should not save the message, only do the alert 

93 case redefineAlert of 

94 "No": return 0 

95 "Cancel": return nl 

96 otherwise: nothing --continue 

97 end case 

98 end if 
99 

1 00 — Define the new mimetype 
101 

102 if verifyMessageHandler(msgHandler_filename) = 0 then —something wrong with 
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103 program file 

104 alertO'Error: invalid message handler program" && msgHandler filename) 

105 return(O) 

106 end if 
107 

108 insert_msgHandler(SGjrYPETABLE, mimeToInstall, msgHandler filename) 
109 

110 if verify IconImage(icon_filename) = 0 then —something wrong with icon file 

1 1 1 alertCError: invalid icon file" && msgHandler_filename Using default icon.") 

1 12 insert_iconFileName(SGJTYPETABLE, mimeToInstall, DEFAULT _ICONFEJE) 

113 else 

1 14 insert_iconFileName(SG_TYPETABLE, mimeToInstall, iconjilename) 

115 end if 
116 

117 if filetype o"" then 

118 insert_fileytype(mimeToInstalI, filetype) 

1 1 9 writeTypeToRegis try (mimeToInstall, filetype) 

120 end if 
121 

1 22 set retVal = writeJTypeTableJFileO 

123 ifretVal = 0then 

124 alert("Error writing typetable to file." && mimeToInstall && "not installed.") 

125 return(O) 

126 elsereturn(l) 
127 

128 end — Ins tall JType 

129 

130 

1 3 1 UNINSTALL JTYPE removes a mimetype and itis properties from both the file and 

132 the global variable SG TYPETABLE 
133 

134 on unInstall_Type mimeType 

135 global SGJTYPETABLE — information on all installed MIME types 
136 

1 37 set SGJTYPETABLE = [:] ~ initialize property list for mimetype information 
138 

139 —read the existing MIME type information into RAM 

140 set SGJTYPETABLE = ReadJTypeTable_File(the pathname & " typetable.txt") 

142 if count(SGJTYPETABLE) = 0 then failed to read typetable file 

1 43 alert ("Error: Failed to read the file of MIMEty pes") 

144 return (0) 

145 end if 
146 

147 delete_mimetype(mimeType) 

149 — write the revised typetable to the file 

150 set retVal = writeJTypeTableJFile() 

151 if retVal = 0 then 

152 alertCError." && mimeToInstall && "could not be uninstalled. Typetable file write 

153 error.") 
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154 return(O) 

155 elsereturn(l) 
156 

157 end unInstall_Type 
158 

159 WRITE JTYPETABLE.FILE writes the information in SGJTYPETAB LE to the 

160 typetable file on disk. This file stores properties associated with each mimetype. 

161 — SGJTYPETABLE is a property list that contains a list of mimetypes. 

1 63 on Write JTypetable_File 

164 global SGJTYPETABLE --. super global variable shared across different MIAWS 

1 65 set fileName = the pathname & "typetable.txt" 

1 66 set bkupFileName = the pathname & " typetable.bak" 

168 if count( SGJTYPETABLE) = 0 then - no mimetypes defined 

169 alert("Error. No mimetype data to write.) 

170 retum(O) 

171 end if 
172 

173 — create backup for typetable file 

174 copyFile(filename, bkFileName) 
175 

176 — start up Fileio Xtra 

177 set mFile = new(xtra "fileio") 
178 

179 set retVal = deleteFile(mFile, filename) - delete old version before rewriting 

1 80 set retVal = createFile(mFile, filename) 

181 if retVal = 0 then 

1 82 alert("Eiror updating typetable file.") 

1 83 renameFile(bkFileName, filename) 

184 return(O) 

185 end if 
186 

187 openFile(mFile, fileName, 2) - open for write access 

188 setPosition(mFile, 0) 
189 

190 — write the data into the file 

191 seti=l 

1 92 set mimeType = getAt(SG_TYPETABLE, i) 

193 repeat while mimeType o 0 

1 94 set dataToWrite = mimetype 

195 put " " & get_filetype(mimetype) into dataToWrite 

196 put " " & get_iconFileName(mimetype) into dataToWrite 

197 put " " & getJtfsgHandler(mimetype) into dataToWrite 

198 writeline(mFile, dataToWrite) 

199 seti=i+l 

200 set mimeType = getAt(SGJTYPETABLE, i) 

201 end repeat 
202 

203 closeFile(mFile) 

204 set retVal = deleteFile(mFile, bkFileName) - delete backup file 
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205 return(O) 

206 end Write_TypeTable_File 

207 — READ_TYPETABLE_FILE reads the typetable file 

208 — and creates a data structure in memory, S G_T YPET A B LE 

209 — SGJTYPETABLE is a property list that contains a list of mimetypes 
210 

2 1 1 When the function returns, the global property list data structure, SGJTYPETABLE, 

212 contains an entry for each mime type. Along with the pathName for the message handling 

213 movie and the IconFile. Later the cast member number for the icon in RAM will be added 

214 to the datastructure. For now these are all set to 0. This data structure looks like, 

215 [ "text/plain": ["txt", 0, "C:\KidCode\text.gif ''C:\KidCode\text.dxr"], "x- 

216 application/grid": ["", 0, "C:\KidCode\grid.gif, "C:\KidCode\grid.dxr M ]] 
217 

218 on Read JTypeTable JFile 

219 global SGJTYPETABLE — super global variable shared across different MIAWS 

220 set fileName = the pathname & "typetable.txt" 
221 

222 set SGJTYPETABLE =[:] - initialize property list for mimetypes 
223 

224 — start up Fiieio Xtra 

225 set mFile = new(xtra "fiieio") 

226 openFile(mFile, fileName, 1) — open for read only access 

227 set status = status(mFile) 
228 

229 if status oO then 

230 alert("Error. Could not open mimetype table: " & error(mFile, status)) 

231 cioseFile(mFile) — just to be safe 

232 return FALSE 

233 end if 
234 

235 setPosition(mFile, 0) 
236 

237 Lingo canft read one line at a time so simulate this by reading the entire file into the 

238 string, str 

239 set str = readFile(mFile) 
240 

241 set nTypes = the number of lines in str 

242 repeat with j = 1 to nTypes 

243 set mimetype = word 1 of line j 

244 insert_mimetype(mimetype) 

245 insert_filetype(mimetype, word 2 of line j) 

246 insert_iconFileName(mimetype, word 3 of line j) 

247 insert_msgHandler(mimetype, word 4 of line j) 

248 end repeat 
249 

250 closeFile(mFile) 
251 

252 end ReadJTypeTable File 

253 

254 

255 on Read_Icon_Files_To_RAM 
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256 global SGJTYPETABLE 

257 global SGJDEFAULTJCON PTR= 1000 
258 

259 if count( SGJTYPETABLE) = 0 then - no mimetypes defined 

260 alert("Error. No mimetype data. Canft load icons.) 

261 retum(0) 

262 end if 
263 

264 — load the default icon 

265 importFileInto(member SG_DEFAULT_ICON_PTR, the pathname & "defaulticon.gif) 
266 

267 — cycle through the mimetypes loading icons 

268 set castNum = SG_DEFAULT_ICON__PTR + 1 -first icon immediately follows the 

269 default 

270 seti=l 

27 1 set mimeType = getAt(SG_TYPETABLE, i) 

272 repeat while mimeType o 0 

273 set iconFile = get_iconFileName(SG_TYPET AB LE, mimetype) 

274 if icon =" " then — icon not defined use default 

27 5 set iconPtr = SG_DEFAULT ICON PTR 

276 else ~ 

277 set iconPtr = read_IconFile(iconFile, castNum ) 

278 if iconPtr >0then 

279 set castNum = castNum + 1 

280 else set iconPtr = SG_DEFAULT_ICON PTR 

281 end if 
282 

283 insert JteonPtr(mimetype, iconPtr) 

284 seti=i+l 

285 set mimeType = getAt(SG_TYPETABLE, i) 

286 end repeat 
287 

288 return(l) 
289 

290 end Read Jcon_Files To RAM 

291 

292 

293 

294 — READJCONFTLE loads a single icon bitmap into RAM 

295 on read JconFile filename, castMemberNum 

296 set retVal = importFileInto(member castNum, iconFile) 

297 return (retVal) 

298 end read_IconFile 

299 — Data Access Functions for MIMETYPE info 

300 — Data is stored in the property list SG_TYPETABLE with the following structure- 

301 — mimetype: properties 

302 — where mimetype is a string, e.g. "text/plain" 

303 — and properties is a list with the following elements: 

304 — [ filetype, iconPtr, iconFilename, msgHandler FileName 

305 — e.g. SG_TYPETABLE = 

306 — [ "text/plain": ["txt", 0, "C:\KidCode\textgif \ M C:\KidCode\text.dxr"], 
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307 — '^-application/grid": ["", 0, ''C:\KidCode\grid.gif n C:\KidCode\grid.dxr"]] 
308 

309 on get_mimetype mimetype 

3 10 global SGJTYPETABLE 

3 1 1 return( getProp(SGJTYPETABLE, mimetype) ) 

312 end 
313 

314 on get_filetype mimetype 

315 global SGJTYPETABLE 

316 set theProperties = getProp(SG JTYPETABLE, mimetype) 

317 return( getAt(theProperties, 1 ) ) 

318 end 
319 

320 on getjconPtr mimetype 

32 1 global SGJTYPETABLE 

322 set theProperties = getProp(SGJTYPETABLE, mimetype) 

323 return( getAt(theProperties, 2) ) 

324 end 
325 

326 on get_iconFileName mimetype 

327 global SGJTYPETABLE 

328 set theProperties = getProp(SGJTYPETABLE, mimetype) 

329 return( getAt(theProperties, 3) ) 

330 end 
331 

332 on get_jmsgHandler mimetype 

333 global SGJTYPETABLE 

334 set theProperties = getProp(SGJTYPETABLE, mimetype) 

335 return( getAt(theProperties, 4) ) 

336 end 
337 

338 on insert_mimetype mimetype 

339 global SGJTYPETABLE 

340 addProp(SG JTYPETABLE, mimetype) 

341 end 
342 

343 on insert_filetype mimetype, filetype 

344 global SGJTYPETABLE 

345 set theProperties = getProp(SGJTYPETABLE, mimetype) 

346 add(theProperties, filetype) 

347 setProp(S G JT YPETABLE, mimetype, theProperties) 

348 end 
349 

350 on insert_iconPtr mimetype, iconPtr 

35 1 global SGJTYPETABLE 

352 set theProperties = getProp(SG_TYPET AB LE, mimetype) 

353 add(theProperties, iconPtr) 

354 setProp(SGJT YPETABLE, mimetype, theProperties) 

355 end 
356 

357 on insert_iconFileName mimetype, iconFilename 
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358 global SG_TYPETABLE 

359 set theProperties = getProp(SG_TYPETABLE, mimetype) 

360 add(thePnoperties, iconFilename) 

362 end setPro P (SG - TYPETABLE » niimetype, theProperties) 

363 ^ 

364 on insert_msgHandler mimetvpe 

365 global SG_TYPETABLE 

366 set theProperties = getProp(SG_TYPETABLE, mimetvpe) 

367 add(theProperties, msgHandler) 

369 end setPro P (SG - TYPETABLE . niimetype, theProperties) 

370 
371 

372 on delete_mimetype mimetvpe 

373 global SG_TYPETABLE 

374 deleteProp(SG_TYPETABLE, mimetype) 

375 end 
376 

377 on delete_filetype mimetype 

378 global SG_TYPETABLE 

379 set properties = getProp(SG_TYPETABLE, mimetype) 

380 setAt(properties, 1,"") 

?5J , setProp(SG_TYPETABLE, mimetype, properties) 

■ioZ end 

383 

384 on delete_icon niimetype 

385 global SG_TYPETABLE 

386 set properties = getProp(SG_TYPETABLE, mimetype) 

387 setAt(properties, 2, 0) 

389 end setPro P (SG - TYPETABLE ' mimetype, properties) 
390 

391 on delete_iconFileName mimetype 

392 global SG.TYPETABLE 

393 set properties = getProp(SG_TYPETABLE, mimetype) 

394 setAt(properties, 3,"") 

396 end SetPro P (SO - TYPETABLE . mimetype, properties) 
397 

398 on delete_msgHandler mimetype 

399 global SG_TYPETABLE 

400 set properties = getProp(SG_TYPETABLE, mimetype) 

401 setAt(properties, 4,"") 

403 d setPr °P (SG - TYPETAB LE, mimetype, properties) 
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Claims: 

1. Electronic mail client software for use with a display device, comprising: 

a) mailbox displayer means for displaying the contents of a mailbox as a scrollable list on the 
display device wherein each item of mail is listed with a plurality of properties, said properties 
selected from the group consisting of subject, sender's name, and date sent; 

b) association means for associating a plurality of mime types with a plurality of icon images, 
wherein 

said mailbox displayer means includes means for determining the mime type of at least 
some items of mail in the mailbox, means for reading said association means, and means for 
displaying in the scrollable list an icon image as a property associated with each of said at least 
some items of mail, said icon image for each of said at least some items of mail being selected 
from said association means according to the mime type for each of said at least some items of 
mail. 

2. Electronic mail client software according to claim 1, further comprising: 

c) type updater means for updating said association means to include additional mime types 
and additional icon images. 

3. Electronic mail client software according to claim 1, further comprising: 
c) a plurality of icon images, each having a filename, wherein 

said association means is a data structure associating each of at least some mime types 
with the filenames of an icon image. 

4. Electronic mail client software according to claim 1, wherein: 

said association means includes means for associating mime types with programs, and 
wherein some mimetypes are not associated with icon images but are associated with 
programs. 

5. Electronic mail client software according to claim 2, wherein: 

said type updater means is responsive to user input. 

6. Electronic mail client software according to claim 3, wherein: 

at least some of said plurality of images are scalable. 
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7. Electronic mail client software according to claim 1, wherein: 

said electronic mail client software is designed to be used with an operating system 
which maintains a registry of icons, and 

said association means associates at least some mime types with icons selected from said 
registry of icons. 

8. Electronic mail client software according to claim 1, further comprising: 

c) icon recovery means for reading graphical icon information contained in an email or email 
attachment, wherein 

said association means associates a mime type with an icon recovered by said icon 
recovery means if no other icon is found. 

9. Electronic mail client software according to claim 2, wherein: 

said type updater means is manually operable by a user of said electronic mail client 
software. 

10. Electronic mail client software according to claim 2, wherein: 

said type updater means automatically installs a new icon image according to an event 
selected from the group consisting of 

a new application or component is installed which is capable of authoring/reading a new 
mime type, 

a new mime type is encountered in a received mail message, and 

a regularly scheduled event causes said type updater to check a server for new icons. 

1 1. A method of displaying a list of the contents of an electronic mail box on a display device, 
comprising: 

a) displaying the contents of the mailbox as a scrollable list on the display device wherein each 
item of mail is listed with a plurality of properties, said properties selected from the group 
consisting of subject, sender's name, and date sent; 

b) determining the mime type of at least some items of mail in the mailbox; 

c) displaying in the scrollable list an icon image as a property associated with each of said at 
least some items of mail, said icon image for each of said at least some items of mail being 
selected according to the mime type for each of said at least some items of mail. 



WO 02/01373 



PCTYUS01/20348 



48 

12. A method according to claim 11, further comprising: 

d) associating mime types with programs; 

e) executing a program associated with a mime type when a mail item of the mime type is 
opened. 

13. A method according to claim 11, wherein: 

at least some of said icon images are scalable. 

14. A method according to claim 1 1, wherein: 

said step of displaying includes selecting at least some icons from a central registry of 

icons. 

V 

15. A method according to claim 1 1, wherein: 

said step of displaying includes reading graphical icon information contained in an email 
or email attachment 

16. A method according to claim 1 1, further comprising: 

d) maintaining a store of graphical icons for use when performing said step of displaying. 

17. A method according to claim 16, further comprising: 

e) automatically installing a new icon image in said store of graphical icons in response to an 
event selected from the group consisting of 

when a new application or component is installed which is capable of authoring/reading 
a new mime type, 

when a new mime type is encountered in a received mail message, and 

when a regularly scheduled event causes said type updater to check a server for new 

icons. 



WO 02/01373 



PCT/US01/20348 




WO 02/01373 



PCT/US01/20348 



2/19 CN 



X 

J 


















From Date Sent * 


secretarytcorp.com Wed, Feb 9, 2000, 4:43 PM 
adman9audio.com Wed, Feb 9, 2000, 4:43 PM 
jsmith9abc.com Wed, Feb 9, 2000, 11:02... 
psmall9xyz.com Wed, Feb 9, 2000, 10:16... 
admdn9photo.com Tue, Feb 8, 2000, 151 PM 
taxman9pain.com Mon, Feb 7, 2000, KfcOi AM 


























M 

* 
B 

lllllll 

o : 


1 inDox 

Display subjects containing: 


! i Subject 


01 Minutes of Meeting 
a New Radio Ad 
Q Sales Forecast 1Q00 
D Customer Database 
© New Ad Brochure 
ED Year End Accounting 








£ 














► 


1 

1 ^ 

SI <0 

n 


m JS 
_ 1 | 

G(ai@r4|rj 


g 
1 



WO 02/01373 



PCT/US01/20348 



3/19 



x 

1 



q> 



CO 

o 



o 

CD 

cm 



CO 



CD 



CO 
CO 
CD 



X 

o 



X 

o 



o 
cu 

.o 

=31 
CO 



23 
o 

am 



OI 



<L> 



1 



nr 



o 



o 

JS 

lo 
o 

CO 



e 

0"» 

o 



l £ 



s 

2 



-♦5 o o 



a> 



o o o 



2* 2* 2" 
o o o 

odd 
poo 

i & <8> & 
n s= <= c: 
' o o o 
; co co 



(Sill 



E 



s 



CD 




s 



E 
o 
o 

42 

CO 



CO 

co 

qp 



CD 
£= 
CO 

51 



CO 
CO 

■si 

1 = 

CO 

O O 3 



CO 
CO 



CO 



o 



I 1 

o 



O. CD 



s 



i gal -o 



8\ 



CO 
CD 



XOKO 



i-o 2£ 

CZ • • • - CD 
CO Q£ OS -5= 



Q_CL<<Q- 



o o <o co co co <o 

^r- <o CO CO CO o CO CO 
-OOCD-^Oiofe 0000 © 00 

<o .<o y-in^om i i «i l_ , , , 

^-000»-00053 



£ CO CO 



CO 
CD 

o 



^ -2-2-2-2-2^^ « ^ 



ro m 



X 
O 



a x o ~_ cq co 
-3 -co 5^ -g 

Q- a. -s ^ x3o x rz> 



CD 
O 



O 

CO 

a 

s 



5 



1 

CM 



o 
E 



O 

jQ 



2 



CD £ £ 

_ CO CD O 
— CD 2 



to 



^ m m m m 



O 



CO 

n 
Ol 

Q 

CD 
X 



WO 02/01373 



PCT/US01/20348 



4/19 



00 




59 lu o 
UJ ^ o 



CD 



7 

o 



WO 02/01373 



PCT/US01/20348 



5/19 

( START 



101 



LOAD GLOBAL VARIABLES 



I 



STORE ICON LIST IN RAM 



j^103 



CLEAR FIELDS AND SPRITES 



107 



109 



FOR NEXT MESSAGE IN LIST 
GET AND DISPLAY TEXT PROPERTIES 



I 



GET MAILBOX, MIME, AND 
STATUS PROPERTIES 



J — 1 13 



115 



SET SPINE CHANNEL COUNTER Y ~ 
PARSE TYPETABLE DATA STRUCTURE | ^ 117 



SET DEFAULT ICON IF NECESSARY \ ^ 



119 



SELECT GREYSCALE ICON IF STATUS 
IS READ 



ADD ICON TO UST FOR SCROLLING 



123 



FORMAT ICON AND TEXT DISPLAY Y ~ 



125 




129 



{ END ) 



127 



FIG.4 



WO 02/01373 



PCT/USOl/20348 



6/19 



201 




FIG.5 



WO 02/01373 PCT/US01/20348 



7/19 




ETC... YES ETC... 




FIG.6 



WO 02/01373 PCT/US01/20348 




WO 02/01373 PCT/US01/20348 



12/19 



N 

START lNITlAUZE_TypeTable J 



360 



SET GLOBAL VARIABLE 
SG_TYPEJABL£=NIL 



-362 



374 



378 



SET GLOBAL VARIABLE 
SG_ATTACH_TYPETABLE=NIL 



^-364 



Read_Typetable_Rle 
(INTO SG_TYPETABL£) 



368 




^366 



YES 



Read_lcon_Files_Jo_RAM 



376 




RETURN SUCCESS 



370 



ALERT USER 
NO MESSAGE TYPES 



r 



372 



RETURN FAILED 



FIG.7 



WO 02/01373 PCT/US01/20348 



13/19 

r~ " START V 

Reo d-TypetableJHIe J 

T 



SET SG_TYPETABL£=NIL 



OPEN FILE TYPETABLEJXT" 



380 



•382 



•384 



386 



391 



RLE OPEN ERROR?^>^- 
,N0 



388 



ALERT USER ERROR 
OPENING *!YPETABLE.TXr 



READ A LINE FROM THE FILE 



394 




YES 



390 



CLOSE THE RLE 



396 



lnsert_Mimetype 
(SG-TYPETABLE, THE RRST WORD OF UNE) 



ALERT USER MIMETYPE 
NOT DEFINED 



YES 



400 




398 



392 



RETURN 
SG_TYPETABLE 



lnsert_filetype 

(SG_TYPETABL E, THE SE COND WORD OF UNE) | 



402 



Insertjcon 
(SG_TYPETABL E, THE THIRD WORD OF UNE) 

I 



-404 



lnsert__msgHandler 
(SG.TYPETABLE, THE FOURT H WORD OF UNE) | 

408 



406 




FIG.8 



WO 02/01373 



PCT/US01/20348 



15/19 



O 
ro 



ft 




» FILE 




a> 
-o 
o 






CKUF 




o 


UJ o 




25 








DELETE 




RETURN 




CO 

? 

V 


CO 

? 



o 



5 



1 





ft 




ft 




II 




















| 




















tj 




CO 



0> 



1 



1 



CD 
C/J 



o 
a> "o 
E"° 

CD 

=5 * 
c 
o 

CO 

E 

-J 
a> 

an 



CD 
O 



CNJ 

in 



CD 



s 

_o 



no 



£5 y 

■ i ■ Cu 

I g 



ft 

-4— » 

os >< 

P 

o a. 

Z UJ 



WO 02/01373 



PCT/DS01/20348 




WO 02/01373 



PCT7US01/20348 



19/19 




CD 



INTERNATIONAL SEARCH REPORT 



International application No. 
PCT/US01/20348 



A. CLASSIFICATION OF SUBJECT MATTER 

DPC(7) :G06F 13/00, 15/16. 
US CL :709/206; 345/700. 
According to International Patent Classification (IPC) or to both national classification and IPC 



B. FIELDS SEARCHED 



Minimum documentation searched (classification system followed by classification symbols) 
U.S. : 709/206; 345/700 



Documentation searched other than minimum documentation to the extent that such documents are included in the fields searched 



Electronic data base consulted during the international search (name of data base and, where practicable, search terms used) 
west 



C. DOCUMENTS CONSIDERED TO BE RELEVANT 



Category* 



Citation of document, with indication, where appropriate, of the relevant passages 



Relevant to claim No. 



A,E 

A,E 

A,P 

A 

A 

A 



US 6,092,114 A (SHAFFER et al) 18 July 2000 

US 6,189,026 Bl (BIRRELL et al) 13 February 2001 

US 6,073,166 A (FORSEN) 06 June 2000 

US 5,752,059 A (HOLLERAN et al) 12 May 1998 

US 5,734,901 A (SIDHU et al) 31 March 1998 

US 5,826,062 A (FAKE, JR. et al) 20 October 1998 



1-17 
1-17 
1-17 
1-17 
1-17 
1-17 



[ | Further documents are listed in the continuation of Box C. | | See patent family annex. 



* Special categories of cited documents: 

"A" document defining the general state of the art which is not considered 

to be of particular relevance 

"E" earlier document published on or after the international ft ling date 

"L" document which may throw doubts on priority claim(s) or which is 

cited to establish the publication date of another citation or other 
special reason (as specified) 

"O* document referring to an oral disclosure, use, exhibition or other 

means 

"P" document published prior to the international filing date but later man 
the priority date claimed 



later document published after the international filing date or priority 
date and not in conflict with the application but cited to understand the 
principle or theory underlying the invention 

document of particular relevance; the claimed invention cannot be 
considered novel or cannot be considered to involve an inventive step 
when the document is taken alone 

document of particular relevance; the claimed invention cannot be 
considered to involve an inventive step when the document is 
combined with one or more other such documents, such combination 
being obvious to a person skilled in the art 

document member of the same patent family 



Date of the actual completion of the international search 
10 AUGUST 2001 



Date of mailing of the international search report 



2 9 AUG 



200)- 



Name and mailing address of the ISA/US 
Commissioner of Patents and Trademarks 
Box PCT 

Washington, D.C. 20231 
Facsimile No. (703) 305-3230 



Authorized officer 

GLENTON BUR< 
Telephone No. (703) 305-4792 



Form PCT/ISA/210 (second sheet) (July 1998)* 



THIS PAGE BLANK (USPTO) 



